Loop Expression Action Icon

Loop Expression Action

Declaration

<AMLOOPEXPRESSION EXPRESSION="text [valid BASIC expression]" CONDITION="text [options]">
  (block of steps to loop)
</AMLOOP>

See Also

Loop, End Loop, Loop Files, Loop Windows, Loop Processes, Loop Dataset, Loop List, Break

Description

Loops while or until the expression specified is true. With each successive loop, the expression is reevaluated. The loop ends after the expression condition is met or when a Break is encountered.

Practical Usage

To continue to execute a block of steps while or until a condition is true.

Parameters

General Tab

Condition
Text [options], Optional default: while
MARKUP: CONDITION="until"

Specifies whether the loop should continue while the expression is true or until it is true.

The available options are:

while: The loop will continue while the expressiopn is true

until: The loop will continue until the expression is true.

Window Handle Variable
Text, Required
MARKUP: EXPRESSION="thenumber = 55"

Specifies a valid BASIC expression that should be evaluated on each loop.

Notes

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Examples

<!--- simple incrementing counter --->
<AMVARIABLE NAME="mycounter">1</AMVARIABLE>
<AMLOOPEXPRESSION EXPRESSION="mycounter=5" CONDITION="until">
   <AMINCREMENTVARIABLE RESULTVARIABLE="mycounter">
</AMLOOP>